home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 194 (1992-03-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 194 (1992-03-10)(Manewaldt, A.)(DE)(PD).adf / PR / PR.doc < prev    next >
Text File  |  1992-02-29  |  18KB  |  419 lines
  1. ==============================================================================
  2. ==============================================================================
  3. ===                  Romanverwaltung 'PR' V2.07a rel. 2010-91              ===
  4. ==============================================================================
  5. ===                       ( S H A R E W A R E )                            ===
  6. ==============================================================================
  7. ===              (benoetigt V34.01 oder hoeher der "ak_gen0.library")      ===
  8. ==============================================================================
  9. ===                                                                        ===
  10. ===                       (c) 1989-91 by Andreas Ralph Kleinert            ===
  11. ===                                      Grube Hohe Grethe 23              ===
  12. ===                                      W-5900 Siegen 1                   ===
  13. ===                                      Germany                           ===
  14. ===                                                                        ===
  15. ==============================================================================
  16. ==============================================================================
  17.  
  18.      "Romanverwaltung 'PR'" ist (C)opyright 1990-91 by Andreas R. Kleinert
  19.      und darf frei kopiert werden. Eine "Entrichtung" des SHARE-Betrages ist
  20.      erwuenscht, aber nicht Zwang. Eine eventuell verlangte Kopiergebuehr pro
  21.      Diskette sollte 10 DM bzw. das 5-fache des Leerdiskettenpreises nicht
  22.      uebersteigen. (Der fuer fruehere Versionen von "Romanverwaltung 'PR'"
  23.      geltende Betrag von 20 DM bzw. 15 DM gilt mit Erscheinen dieser Version
  24.      NICHT mehr).
  25.      ERWUENSCHT ist allerdings ein Betrag, der, bis auf eine geringe Kopier-
  26.      gebuehr, in etwa dem Preis einer Leerdiskette entspricht.
  27.      "Romanverwaltung 'PR'" darf nicht unvollstaendig weitergegeben werden !
  28.      Bestandteile von "Romanverwaltung 'PR'" V2.07a sind :
  29.  
  30.       - diese Anleitung
  31.       - "Romanverwaltung 'PR'" V2.07a selbst
  32.       - PRConvert V2.07a
  33.       - die "ak_gen0.library" und ihre Anleitung
  34.       - der restliche Inhalt dieses Directories, soweit als Bestandteil
  35.         von "Romanverwaltung 'PR'" gekennzeichnet
  36.  
  37.      ----- Dokumentationsfile-Version : V2.07a-A-2010-91 -----
  38.  
  39. =============================================================================
  40. = PROGRAMMBESCHREIBUNG :                                                    =
  41. =============================================================================
  42.  
  43.      "Romanverwaltung 'PR' V2.07a" ist ein Programm zum planmaessi-
  44.      gen Erfassen, Verwalten und Auswerten von groesseren Bestaen-
  45.      den an Zeitschriften, Buechern, oder insbesondere sogenannten Heft-
  46.      ("Groschen-")romanen.
  47.      (Dieses Programm ist besonders fuer Sammler geeignet.)
  48.  
  49.      Benoetigter Speicher :
  50.                             - ideal : 1 MB oder mehr
  51.                               (Am besten 1 MB ChipRAM !)
  52.      System-Konfiguration :
  53.                             - Kickstart V1.2/V1.3 (evtl. OS V2.00)
  54.                               (FALLS MOEGLICH, "SetPatch V1.38" ODER HOEHER
  55.                                INSTALLIEREN)
  56.                             - benoetigt ak_gen0.library V34.01 oder hoeher
  57.  
  58.      Kapazitaet           :
  59.                             - theoretisch nur durch die Kombinations-
  60.                               moeglichkeiten des Suchbegriffs (7 Zeichen)
  61.                                und den freien Speicher begrenzt
  62.                             -   7 Zeichen Suchbegriff +
  63.                                99 Zeichen Titel       +
  64.                               199 Zeichen Untertitel  +
  65.                                29 Zeichen Autorenname +
  66.                                29 Zeichen ISBN-Nr.
  67.      Features             :
  68.                             - komfortable Eingabemoeglichkeit
  69.                             - Loeschfunktion
  70.                             - Suchfunktion fuer Titel
  71.                             - Suchfunktion fuer Autoren
  72.                             - Listenausgabe (Drucker)
  73.                             - etc.
  74.  
  75.      Besonderheit(en)     :
  76.                             - dynamische Speicherverwaltung nach dem Listen-
  77.                               system (Verwendung von "Nodes")
  78.  
  79. =============================================================================
  80. = HINWEIS :                                                                 =
  81. =============================================================================
  82.  
  83.      DIESES PROGRAMM IST SHAREWARE !!!
  84.    
  85.    - Was bedeutet dies konkret ?
  86.  
  87.      Wenn Sie dieses Programm regelmaessig benutzen, entrichten Sie bitte
  88.      einen SHARE-Betrag von DM 15 an mich. Dies ist jedoch FREIWILLIG
  89.      (deshalb ist dieses Programm keine KOMMERZIELLE Shareware) !!!
  90.      Haben Sie den SHARE-Betrag an mich entrichtet, so koennen Sie von
  91.      mir gegen Leerdiskette und Rueckporto (RP) jeweils die neueste Version
  92.      dieses Programmes in regelmaessigen Abstaenden (also ca. >= 2-3 Mon.)
  93.      erhalten.
  94.  
  95.      Dieses Angebot gilt solange, bis ich mich, aus welchen Gruenden auch im-
  96.      mer, nicht mehr in der Lage sehe, es zu diesen vergleichsweise gross-
  97.      zuegigen Bedingungen zu erfuellen (s.u.).
  98.  
  99.  
  100.    - Was geschieht, wenn dieses Angebot einmal NICHT mehr gelten
  101.      sollte (s.o.) ?
  102.  
  103.      Alternativen :
  104.  
  105.      a) Es faende keine Weiterentwicklung mehr statt.
  106.         (Unwahrscheinlich aber moeglich.)
  107.  
  108.       oder :
  109.  
  110.      b) Dieses Programm koennte in einer spaeteren Version als kommerzielle
  111.         Shareware vertrieben werden, eventuell mit Rabatt fuer diejenigen,
  112.         die bereits den freiwilligen Sharebetrag bezahlt haben.
  113.  
  114.       oder :
  115.  
  116.      c) Dieses Programm koennte in einer spaeteren Version komplett kommer-
  117.         ziell vertrieben werden.
  118.  
  119.      Fazit :
  120.  
  121.      Wuerde mir jemand, nachdem dieses Angebot bereits NICHT mehr gilt, noch
  122.      15 DM + RP + Leerdiskette zusenden, so wuerde ich den dazu notwendigen
  123.      Teil des RP dazu verwenden, um die 15 DM sowie die Diskette (leer) und
  124.      den Rest des RP zurueckzusenden, und ausserdem eine Information beilegen,
  125.      die Auskunft darueber gibt, welchen Status (a,b,c,?) die neue Version
  126.      des Programmes nun besizt und warum.
  127.      Selbstverstaendlich erhielten dann auch alle diejenigen, die bereits den
  128.      SHARE-Betrag bezahlt haben und mir eine Diskette mit RP schickten, um
  129.      ein Update zu bekommen, die Diskette und den Rest des RP zurueck, aller-
  130.      dings eventuell noch zusaetzlich mit einem Vorzugsangebot fuer die neue
  131.      Version (s.o.).
  132.  
  133.      Dies ist jedoch momentan alles (noch) nicht in greifbarer Naehe. Auch
  134.      glaube ich nicht, dass dieses Programm bereits ausgereift genug waere,
  135.      um auf dem kommerziellen (Shareware-)Markt Bestand haben zu koennen.
  136.  
  137.      Es lohnt sich also, einmal darueber nachzudenken, die (freiwillige)
  138.      SHAREWARE-Idee zu foerdern, zumal niemand ein Risiko eingeht (schon gar
  139.      nicht bei 15 DM) !
  140.  
  141.    - Notwendige Infomationen fuer mich :
  142.  
  143.      Geben Sie bitte immer auf jeden Fall die Version dieses Programmes an,
  144.      die Sie besitzen, so dass ich sehe, ob ein "Update" schon (oder noch)
  145.      moeglich bzw. sinnvoll ist.
  146.      Vergessen Sie bitte auch nicht, fuer alle Faelle Ihre Telefonnummer an-
  147.      zugeben !!!
  148.  
  149. =============================================================================
  150. = INSTALLATION :                                                            =
  151. =============================================================================
  152.  
  153.     Kopieren Sie die beigefuegte (oder eine hoehere) Version der
  154.     "ak_gen0.library" in das "LIBS:"-Verzeichnis (normalerweise "SYS:libs").
  155.  
  156. =============================================================================
  157. = START :                                                                   =
  158. =============================================================================
  159.  
  160.     1) Sorgen Sie fuer genuegend freien Speicher (besonders CHIP-Mem).
  161.     2) Ueberpruefen Sie die Stack-Groesse (naeheres s.u.).
  162.     3) Gehen Sie sicher, dass die "ak_gen0.library" V34.01 oder hoeher sich in
  163.        "LIBS:" befindet.
  164.     4) Starten Sie "Romanverwaltung 'PR'" durch :
  165.  
  166.         a) Start von der Workbench (Vorgehensweise bekannt).
  167.  
  168.         b) Eingabe von b.1)     Run PR
  169.  
  170.                       oder
  171.  
  172.                        b.2)     PR 
  173.  
  174.            im CLI / in der Shell.
  175.  
  176.     Falls Probleme auftauchen sollten, lesen Sie bitte die untenstehenden,
  177.     diesbezueglichen Hinweise (moeglichst schon vorher !).
  178.  
  179. =============================================================================
  180. = BEDIENUNG :                                                               =
  181. =============================================================================
  182.  
  183.    (Weitestgehend selbsterklaerend. Eine genauere Anleitung ist von mir
  184.     wie oben bereits erwaehnt erhaeltlich !)
  185.  
  186.  
  187.    - Aussehen einer PRCard, Bedeutung der Eintraege :
  188.  
  189.      Nummer     :
  190.                   Suchbegriff (am besten Zahl). Keine Positionsangabe !
  191.                   [ Zahl / String    ]
  192.                   [ max. 7 Zeichen   ]
  193.      Titel      :
  194.                   Titel des Romans
  195.                   [ Text             ]
  196.                   [ max. 99 Zeichen  ]
  197.      Untertitel :
  198.                   Zweiter Titel und/oder andere Informationen
  199.                   [ Text             ]
  200.                   [ max. 199 Zeichen ]
  201.      Autor      :
  202.                   Autorenname / Pseudonym
  203.                   [ Text             ]
  204.                   [ max. 29  Zeichen ]
  205.      ISBN-Nr.   :
  206.                   ISBN-Nr. oder andere Informationen
  207.                   [ Text             ]
  208.                   [ max. 29 Zeichen  ]
  209.  
  210.    - Verwendung der Suchfunktion :
  211.  
  212.      Die Funktion "Suchen" beruecksichtigt Gross-/Kleinschrift !
  213.  
  214.    - Verwendung von "PRConvert V2.07a"
  215.  
  216.      Fuer alle Benutzer frueherer Versionen ist dieses Hilfsprogramm ge-
  217.      eignet. Es konvertiert alte Datensaetze (Dateien mit Endung '.dat')
  218.      in die neue, fuer diese Version geeignete Form.
  219.      Diese neue Form benoetigt allerdings mehr Platz als die aeltere.
  220.      Bitte beachten Sie dies, damit Sie nicht unerwartet Platzprobleme
  221.      bekommen !
  222.  
  223. =============================================================================
  224. = WICHTIGE HINWEISE :                                                       =
  225. =============================================================================
  226.  
  227.    (1)
  228.  
  229.    Wenn Sie "Romanverwaltung 'PR'" nicht mit dem Original-ICON von der Work-
  230.    bench aus starten, achten Sie bitte darauf, dass der voreingestellte Stack-
  231.    speicher mindestens 25000 Bytes umfasst (meistens reicht auch weniger, aber
  232.    sicher ist sicher(er) !). Im Zweifelsfall bitte auch die Eintragung im
  233.    ICON ueberpruefen (s.u.) !
  234.  
  235.    Die Einstellung der Stackgroesse kann erfolgen :
  236.  
  237.     1) bei Workbench-Start : im "Info"-Menue der Workbench.
  238.  
  239.      oder
  240.  
  241.     2) bei CLI-/Shell-Start : mit dem "Stack"-Befehl
  242.  
  243.    ACHTUNG :
  244.  
  245.    DIES WAR EINE DER HAEUFIGSTEN ABSTURZURSACHEN FRUEHERER VERSIONEN !
  246.    (DIESE STUERZTEN AB, OBWOHL SIE EIGENTLICH FEHLERFREI WAREN, DA DER
  247.     STACK ZU KNAPP BEMESSEN WAR !!!!!!!)
  248.  
  249.    (2)
  250.  
  251.    Sorgen Sie dafuer, dass beim Einlesen von Dateien genuegend Speicher fuer
  252.    die Daten vorhanden ist !
  253.    Ein Eintrag benoetigt 100 (Titel) + 200 (Untertitel) + 30 (Autor) + 30
  254.    (ISBN-Nr.) + 22 (Verwaltung) = 382 Bytes.
  255.  
  256.    Das ergibt fuer eine Datei mit 200 Eintraegen einen Speicherplatzbedarf
  257.    von :
  258.  
  259.     (200)*(382) = 76400 Bytes.
  260.  
  261.    Die Aufteilung groesserer Verwaltungseinheiten in kleinere Untergruppen
  262.    bietet sich an (z.B. : Romane_1.dat, Romane_2.dat, Romane_x.dat).
  263.  
  264.    Es empfiehlt sich, "Romanverwaltung 'PR'" mittels "Run" vom CLI aus zu
  265.    starten, oder aber ein CLI "nebenher" laufen zu lassen, um zwischendurch
  266.    mit "Avail" den freien Speicher ueberpruefen zu koennen.
  267.  
  268.    Spaetere Versionen von "Romanverwaltung 'PR'" werden dies alles moeglicher-
  269.    weise selbst erledigen koennen.
  270.  
  271. =============================================================================
  272. = VERSIONS-"HISTORY" :                                                      =
  273. =============================================================================
  274.  
  275.    V1.0  :
  276.  
  277.     - Erste Version.
  278.  
  279. ------------------------------------------------------------------------------
  280.  
  281.    V1.11 :
  282.  
  283.     - Implementation einer Druckerroutine
  284.     - Verbesserung der CLS-Routine
  285.     - Fehlerkorrektur an den Load- und Saveroutinen
  286.     - Ermoeglichen der Verwendung von Leerzeichen (vorher : "_")
  287.     - Optimierung der Programmstruktur
  288.  
  289. ------------------------------------------------------------------------------
  290.  
  291.    V1.12 :
  292.  
  293.     - Verkleinerung des Programmcodes um mehr als 3000 Bytes bei gleicher
  294.       Leistung (durch Optimierung der Programmstruktur)
  295.     - kleinere Veraenderungen 
  296.  
  297. ------------------------------------------------------------------------------
  298.  
  299.    V1.13 :
  300.  
  301.     - Verkleinerung des Programmcodes durch Nutzung der "ak.library"
  302.     - kleinere Fehlerkorrekturen
  303.     - Codeoptimierungen 
  304.  
  305. ------------------------------------------------------------------------------
  306.  
  307.    V1.14 :
  308.  
  309.     - Veraenderungen am Programmaufbau
  310.     - kleinere Fehlerkorrekturen
  311.     - Codeoptimierungen
  312.  
  313. ------------------------------------------------------------------------------
  314.  
  315.    V2.00a :
  316.  
  317.     - erhebliche Veraenderungen am Aufbau des Programmes
  318.     - Ueberarbeitung der wesentlichsten Programmteile
  319.     - optische Verbesserungen
  320.     - vermehrte Integrierung von Requester-Abfragen an wichtigen Stellen
  321.     - erhebliche Verbesserung des File-Requesters
  322.  
  323. ------------------------------------------------------------------------------
  324.  
  325.    V2.03 :
  326.  
  327.     - Korrektur eines schwerwiegenden Fehlers am Filerequester (wurde von
  328.       mir leider erst nach der Testphase bemerkt)
  329.     - erhebliche Veraenderungen am Aufbau des Programmes
  330.     - Einbau verschiedener neuer Sicherheitsabfragen
  331.     - neue Hilfen (Gadgets) bei der Ein-/Ausgabe
  332.     - Veraenderung des Abspeicher- und Ladeverhaltens auf Diskette
  333.     - variable Speicherverwaltung !!!
  334.     - Nutzung der Version V34.00 der "ak.library"
  335.  
  336. ------------------------------------------------------------------------------
  337.  
  338.    V2.04 :
  339.  
  340.     - Sehr starke Verkuerzung des Programmcodes
  341.     - Korrektur des Abspeicher- und Ladeverhaltens auf Diskette
  342.       (zus. Sicherheitsabfrage, anderes Einleseverhalten)
  343.     - Nutzung der Version V34.10 der "ak.library"
  344.  
  345. ------------------------------------------------------------------------------
  346.  
  347.    V2.06a :
  348.  
  349.     - komplette Ueberarbeitung des Programmes
  350.     - vollkommen dynamische Speicherverwaltung (Verwendung von Listen, Nodes)
  351.     - komfortablere Handhabung
  352.     - weitere Informationen verwaltbar (Autor, ISBN-Nummer)
  353.     - erweiterte Suchfunktion
  354.     - Leerzeichenkonvertierung komplett ueberfluessig, da anderes Abspeicher-
  355.       verfahren
  356.     - Integrierung einer Loeschfunktion
  357.     - verschiedene andere Veraenderungen
  358.  
  359. ------------------------------------------------------------------------------
  360.  
  361.    V2.06b :
  362.  
  363.     - Umstellung auf 'ak_gen0.library' V34.01
  364.  
  365. ------------------------------------------------------------------------------
  366.  
  367.    V2.07a :
  368.  
  369.     - Verwendung der Farben von OS 2.04
  370.     - alle Gadgets jetzt im OS 2.04-Look
  371.     - kleinere Veraenderungen im Source
  372.     - Korrektur in der Fehlerbehandlung
  373.     - Fehler im "Suchen"-Menue beseitigt
  374.  
  375. ------------------------------------------------------------------------------
  376. ------------------------------------------------------------------------------
  377.  
  378.    Bekannte Fehler :
  379.  
  380.     - es sind keine Fehler bekannt
  381.  
  382.     (fuer bekannte Fehler der 'ak_gen0.library', siehe deren Dokumentation)
  383.  
  384. ------------------------------------------------------------------------------
  385. ------------------------------------------------------------------------------
  386.  
  387.    Moegliche weitere Verbesserungen in spaeteren Versionen :
  388.  
  389.    - weitere interne Umkonfigurierung(en)
  390.    - weitere Erweiterung(en) des Funktionsumfanges
  391.    - weitere Optimierung(en) der Programmstruktur
  392.    - Fehlerverbesserung(en)
  393.      Ich bitte ausdruecklich um die Zusendung von "BUG-Reports" !
  394.  
  395. =============================================================================
  396. = INFORMATIONEN ZUR 'ak_gen0.library' :                                          =
  397. =============================================================================
  398.  
  399.     Die mit diesem Programm zu verwendende "ak_gen0.library" besitzt eine ei-
  400.     gene Dokumentation. Bitte aufmerksam durchlesen !
  401.     Danke !
  402.  
  403. =============================================================================
  404. = COPYRIGHTS :                                                              =
  405. =============================================================================
  406.  
  407. =============================================================================
  408. =   "Romanverwaltung 'PR'"                                                  =
  409. =   (c) 1989-91 by Andreas R. Kleinert.                                     =
  410. =   SHAREWARE. All rights reserved.                                         =
  411. =============================================================================
  412. =   "ak_gen0.library"                                                       =
  413. =   (c) 1991 by Andreas R. Kleinert.                                        =
  414. =   FREEWARE. All rights reserved.                                          =
  415. =============================================================================
  416. =   Copyrights zu anderen erwaehnten Produkten/Programmen sind den jeweili- =
  417. =   gen Produktbeschreibungen der Hersteller/Verteiber zu entnehmen.        =
  418. =============================================================================
  419.